﻿// ------------------------------------------------------------------------
// 项目名称：Canroc.Net 
// 版权归属：Canroc（https://gitee.com/canroc）
//
// 许可证信息
// Canroc.Net项目主要遵循 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-APACHE 文件。
//
// 使用条款：
// 1.使用本项目应遵守相关法律法规和许可证的要求。
// 2.不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动。
// 3.任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任
//
// 免责声明
// 对于因使用本代码而产生的任何直接、间接、偶然、特殊或后果性损害，我们不承担任何责任。
//
// 其他重要信息
// Canroc.Net 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。
// ------------------------------------------------------------------------

namespace Canroc.Net.RemoteHttp.WeChat.Dto;

/// <summary>
///     微信H5用户信息
/// </summary>
public class WeChatOpenApiUserInfoOutput
{
    /// <summary>
    ///     用户的唯一标识
    /// </summary>
    [JsonPropertyName("openid")]
    public string Openid { get; set; } = string.Empty;

    /// <summary>
    ///     用户昵称
    /// </summary>
    [JsonPropertyName("nickname")]
    public string NickName { get; set; } = string.Empty;

    /// <summary>
    ///     用户性别(0: 未知 1: 男 2: 女)
    /// </summary>
    [JsonPropertyName("sex")]
    public int Sex { get; set; }

    /// <summary>
    ///     用户个人资料填写的省份
    /// </summary>
    [JsonPropertyName("province")]
    public string Province { get; set; } = string.Empty;

    /// <summary>
    ///     普通用户个人资料填写的城市
    /// </summary>
    [JsonPropertyName("city")]
    public string City { get; set; } = string.Empty;

    /// <summary>
    ///     国家，如中国为CN
    /// </summary>
    [JsonPropertyName("country")]
    public string Country { get; set; } = string.Empty;

    /// <summary>
    ///     用户头像
    /// </summary>
    /// <remarks>
    ///     最后一个数值代表正方形头像大小（有0、46、64、96、132 数值可选，0:代表640*640正方形头像），用户没有头像时该项为空。若用户更换头像，原有头像URL将失效。
    /// </remarks>
    [JsonPropertyName("headimgurl")]
    public string HeadImgUrl { get; set; } = string.Empty;

    /// <summary>
    ///     用户特权信息
    /// </summary>
    /// <remarks>
    ///     json 数组，如微信沃卡用户为（chinaunicom）
    /// </remarks>
    [JsonPropertyName("privilege")]
    public List<string> Privilege { get; set; } = [];

    /// <summary>
    ///     只有在用户将公众号绑定到微信开放平台账号后，才会出现该字段。
    /// </summary>
    [JsonPropertyName("unionid")]
    public string Unionid { get; set; } = string.Empty;
}